.TH "dconvlum" 1 "20 Dec 2005" "Version Version 3.5.4" "OFFIS DCMTK" \" -*- nroff -*-
.nh
.SH NAME
dconvlum \- Convert VeriLUM files to DCMTK display files
.SH "SYNOPSIS"
.PP
.PP
.nf

dconvlum in-file out-file [ambient]
.fi
.PP
.SH "DESCRIPTION"
.PP
Command line program that converts VeriLUM file with characteristic curve data (\fICCx_xx.dat\fP) to a format used for the Barten transformation in this toolkit. VeriLUM is a calibration package from ImageSmiths consisting of a photometer (with serial RS232 connector) and a Windows NT software.
.SH "PARAMETERS"
.PP
.PP
.nf

in-file   VeriLUM characteristic curve file to be converted

out-file  DCMTK display file to be written

ambient   ambient light (cd/m^2, floating point value)
.fi
.PP
.SH "NOTES"
.PP
The output file describing the characteristic curve of a display system (monitor) is a simple text file. Lines starting with a '#' are treated as comments and therefore skipped as well as blank lines. This conversion program creates such a file automatically (including some comment lines) by transforming the information stored in the VeriLUM file. The number following the magic word 'max' defines the maximum DDL value (e.g. 255 for 8 bit displays). This definition is required before the luminance data can be defined. Optionally the ambient light value can be specified in this file too. The floating point value (in candela per square meter) must follow the word 'amb'. Finally the luminance values are defined for each corresponding DDL (device driving level) value. The entries do not necessarily have to be ordered or complete, i.e. there can be less than 'max' + 1 entries. Missing values are calculated by cubic spline interpolation.
.PP
See DICOM standard part 14 for more details on display calibration and Barten's model (including GSDF).
.SH "SEE ALSO"
.PP
\fBdcmdspfn\fP(1), \fBdcm2pnm\fP(1)
.SH "COPYRIGHT"
.PP
Copyright (C) 1999-2004 by Kuratorium OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany. 
